home *** CD-ROM | disk | FTP | other *** search
/ Aminet 23 / Aminet 23 (1998)(GTI - Schatztruhe)[!][Feb 1998].iso / Aminet / util / conv / TextCnvDocs.lha / textconvdocs151d / developer / ACTformatD.txt < prev    next >
Encoding:
Text File  |  1997-10-13  |  8.0 KB  |  239 lines
  1. Beschreibung des AsciiConversionTable (ACT) - Formats
  2. ©1997 Scitech Software Development
  3.  
  4.  
  5. Inhalt:
  6.  
  7. 1) Allgemeines
  8. 2) Rechtliches
  9. 2.1) Copyright und Weitergabe dieses Archivs
  10. 2.2) Veröffentlichung eigener ACT-Dateien
  11. 2.3) Beispielprogramme
  12. 3) Aufbau des ACT-Formats
  13. 3.1) Headerteil
  14. 3.2) Datenteil
  15. 3.3) Kommentare
  16. 4) Beispielprogramme
  17. 5) Adresse das Autors
  18.  
  19.  
  20.  
  21. 1) Allgemeines
  22.  
  23. Warum externe Konvertiertabellen?
  24.  
  25. Als ich entdeckte, daß in der TextConv-Version 1.0 Fehler in der
  26. Macintosh-Konvertierung sind, wurde klar, daß solche Fehler in
  27. zukünftigen Versionen nur dann einfach behoben werden können, wenn
  28. diese Daten als externe Dateien vorliegen.
  29.  
  30. Durch diese Ausgliederung wird außerdem Programmierern und
  31. fortgeschrittenen Benutzern die Möglichkeit gegeben, nicht nur
  32. eventuell vorhandene Fehler selbst auszubessern, sondern auch das
  33. Konvertierergebnis besser an eigene Wünsche anzupassen.
  34.  
  35. Da die einzelnen Zeichensätze nicht 1:1 übertragbar sind, ist hier
  36. (z.B. bei den MS-DOS oder Atari-Grafikzeichen) ein großer Bereich,
  37. der nach rein subjektiven Gesichtspunkten geändert und angepaßt
  38. werden kann.
  39.  
  40. Es wurde bewußt darauf verzichtet, ein Zusatzprogramm zu schreiben,
  41. mit dem die Dateien auch von unerfahrenen Benutzern leicht
  42. geändert werden können, da dies eher zusätzlich Probleme und Fehler
  43. verursacht als solche zu beheben.
  44.  
  45.  
  46.  
  47. 2) Rechtliches
  48.  
  49. 2.1) Copyright und Weitergabe dieses Archivs
  50.  
  51. Dieses Archiv und die darin enthaltenen Dateien sind FREEWARE, das
  52. heißt, man darf es unentgeltlich benutzen und weitergeben.
  53. Die Bestimmungen für die Weitergabe sind identisch mit den
  54. Bedingungen für das Programm TextConv selbst; Details siehe in der
  55. Anleitung von TextConv (Kapitel 4.3).
  56. Das Archiv darf in jedem Fall nur als Ganzes weitergegeben werden;
  57. die Weitergabe oder Veröffentlichung einzelner Dateien ist untersagt.
  58.  
  59.  
  60. 2.2) Veröffentlichung eigener ACT-Dateien
  61.  
  62. Um Probleme und Verwechslungen zu vermeiden, müssen bei der
  63. Veröffentlichung von eigenen ACT-Datei gewisse Regeln eingehalten
  64. werden.
  65.  
  66. Selbst erstellte ACT-Dateien dürfen beliebig weitergegeben oder
  67. veröffentlicht werden, wenn folgende Bedingungen eingehalten werden:
  68.  
  69. 1) Am Ende der ACT-Datei ist ein Kommentar anzuhängen, der darauf
  70.    hinweist, daß es sich nicht um eine original SciTech-ACT-Datei
  71.    handelt.
  72. 2) Das veröffentlichte Archiv muß eine readme-Datei enthalten, die
  73.    1) darauf hinweist, daß es sich nicht um eine original SciTech-
  74.       ACT-Datei handelt
  75.    2) eine kurze Beschreibung beinhaltet, die die Unterschiede zur
  76.       jeweiligen Originaldatei aufzeigt
  77. 3) Falls die Veröffentlichung im AmiNet erfolgt, muß das Archiv im
  78.    selben Verzeichnis wie TextConv plaziert werden (dies ist das
  79.    Verzeichnis util/conv). Die AmiNet readme-Datei muß darauf
  80.    hinweisen, daß es sich nicht um ein original SciTech-Archiv
  81.    handelt.
  82. 4) SciTech muß von der Veröffentlichung schriftlich oder per
  83.    e-mail in Kenntnis gesetzt werden; die Übersendung einer
  84.    Kopie der ACT-Datei ist wünschenswert.
  85.    Die Benachrichtigung ist an die Adresse des Autors
  86.    (siehe unten) zu senden.
  87.  
  88. ACT-Dateien, die nur für den eigenen Bedarf entwickelt werden,
  89. unterliegen keinerlei Beschränkungen.
  90.  
  91.  
  92. 2.3) Beispielprogramme
  93.  
  94. Die in diesem Archiv enthaltenen Beispielprogramme dürfen beliebig
  95. verwendet werden; Programme, die Teile dieses Codes verwenden,
  96. unterliegen seitens SciTech keinerlei Beschränkungen.
  97. Die Weitergabe oder Veröffentlichung der unveränderten Dateien
  98. außerhalb dieses Archivs ist allerdings strikt untersagt!
  99. (siehe Punkt 2.1)
  100.  
  101.  
  102.  
  103. 3) Aufbau des ACT-Formats
  104.  
  105. Eine ACT-Datei ist prinzipell in 2 Teile gegliedert:
  106. - der Headerteil, welcher die MagicByte-Kennung, die Versionsnummer 
  107.   und die  genaue Bezeichnung der Tabelle enthält.
  108. - der Datenteil, welcher die Konvertierungsdaten beinhaltet.
  109.  
  110. Diese 2 Teile müssen enthalten sein, zusätzlich kann dahinter noch
  111. ein beliebig langer Kommentar angefügt werden. 
  112.  
  113. Da sowohl der Header- als auch der Datenteil konstante Länge 
  114. aufweisen, ist auch die Gesamtgröße einer ACT-Datei ohne
  115. Kommentare immer konstant (276 Byte). Da TextConv nur diese
  116. 276 Bytes auswertet, unterliegt der Kommentarteil keinerlei 
  117. Einschränkungen hinsichtlich Länge und Inhalt.
  118.  
  119.  
  120. 3.1) Headerteil
  121.  
  122. Wie oben bereits erwähnt, ist die Länge des Headers fix vorgegeben
  123. und beträgt 20 Byte (Position 0-19 dez., 0-13 hex.).
  124.  
  125. Der Aufbau gliedert sich folgendermaßen:
  126.  
  127. Pos. abs: 00 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 
  128. Pos. rel: 00 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 
  129. Wert txt: S  C  T  A  C  T           A  T  A  R  I  2  A  N  S  I 
  130. Wert hex: 53 43 54 41 43 54 01 00 20 41 54 41 52 49 32 41 4E 53 49 20
  131.  
  132. Erklärung der einzelnen Positionen:
  133.  
  134. Position 0-5:  MagicByte-Kennung SCTACT
  135. Position 6:    Versionsnummer (z.Zt. immer 1 [Datentyp: UBYTE])
  136. Position 7:    Unterversionsnummer (z.Zt. immer 0 [Datentyp: UBYTE])
  137. Position 8:    Blank (Hex 20)
  138. Position 9-18: Bezeichnung der ACT-Datei (hier als Bsp: ATARI2ANSI)
  139. Position 19:   Blank (Hex 20)
  140. ab Position 20 Datenteil
  141.  
  142. MagicByte-Kennung: anhand der Zeichenfolge SCTACT erfolgt die 
  143.   Identifikation als SciTech Ascii-Conversion-Table-Datei.
  144. Versions- und Unterversionsnummer: zur Zeit immer 1 und 0, andere
  145.   Werte führen zu einer Fehlermeldung.
  146. Bezeichnung der ACT-Datei: diese Zeichenfolge korrespondiert immer
  147.   mit dem jeweiligen Dateinamen und muß exakt dem vorgegebenen
  148.   Wert entsprechen. TextConv wählt anhand der Einstellungen
  149.   "Dateien lesen als" und "Dateien speichern als" die jeweils gültige
  150.   Datei aus.
  151.   Die Bezeichnung kann maximal 9 Zeichen lang sein; kürzere
  152.   Bezeichnungen sind mit Blanks aufzufüllen.
  153.    
  154.   Folgende Namen sind zur Zeit möglich:
  155.   
  156.   Dateiname:           Bezeichnung:
  157.   
  158.   ansi2atari.act       ANSI2ATARI
  159.   ansi2ibm.act         ANSI2IBM
  160.   ansi2mac.act         ANSI2MAC
  161.   atari2ansi.act       ATARI2ANSI
  162.   atari2ibm.act        ATARI2IBM
  163.   atari2mac.act        ATARI2MAC
  164.   ibm2ansi.act         IBM2ANSI
  165.   ibm2atari.act        IBM2ATARI
  166.   ibm2mac.act          IBM2MAC
  167.   mac2ansi.act         MAC2ANSI
  168.   mac2atari.act        MAC2ATARI
  169.   mac2ibm.act          MAC2IBM
  170.  
  171.   Wird zum Beispiel die Datei ansi2atari.act von TextConv geöffnet, 
  172.   so wird explizit die Zeichenfolge ANSI2ATARI geprüft;
  173.   ist der String nicht ident, so wird eine Fehlermeldung ausgegeben.  
  174.  
  175.  
  176. 3.2) Datenteil
  177.  
  178. Der Datenteil beginnt an der Position 20 (dec) und ist immer 256 Byte 
  179. lang.
  180.  
  181. Pos. abs: 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39  
  182. Pos. rel: 00 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 
  183. Wert:     UBYTE-Werte entsprechend der Kodierungsvorschrift
  184.  
  185. Die Kodierung erfolgt folgendermaßen:
  186. Die relative Position entspricht dem ASCII-Wert der Quelldatei; der 
  187. Wert an dieser Position entspricht dem ASCII-Wert der Zieldatei.
  188.  
  189. Ein Beispiel: 
  190. Der ASCII-Wert 232 aus der Quelldatei ausgelesen.
  191. Der konvertierte Wert wird nun gefunden, indem man den Byte-Wert
  192. an der absoluten Position 20+232=252 ausliest.
  193.  
  194. Da die ersten 127 Zeichen auf allen Systemen identisch sind, 
  195. entsprechen die Werte dieser Zeichen den relativen Positionen.
  196.  
  197. Zu beachten ist, daß die Zeichen CR (13 (dec.)) und LF (10 (dec.))
  198. im Rahmen der Steuerzeichenkonvertierung gesondert behandelt 
  199. werden; diese Werte dürfen also keinesfalls geändert werden. 
  200.  
  201.  
  202. 3.3) Kommentare
  203.  
  204. Da TextConv alle Zeichen nach der Position 276 ignoriert, können
  205. (im Falle einer Veröffentlichung müssen) ab dieser Position beliebige
  206. Kommentare eingefügt werden. Diese sind, wie oben bereits erwähnt,
  207. hinsichtlich Länge und Inhalt in keinster Weise eingeschränkt.
  208.  
  209.  
  210.  
  211. 4) Beispielprogramme
  212.  
  213. Diesem Archiv liegen auch 2 Beispielprogramme bei, die die Erstellung
  214. und das Auslesen aus ACT-Dateien zeigen:
  215. - readconvtab.c
  216. - genconvtab.c
  217.  
  218. readconvtab.c ist ein Codefragment des Original TextConv-Codes, 
  219. welcher dokumentiert, auf welche Art und Weise ACT-Dateien
  220. von TextConv interpretiert werden.
  221.  
  222. genconvtab.c ist der Originalcode, mit welchem alle TextConv
  223. beiliegenden ACT-Dateien erstellt wurden. Mit diesem Programm ist es
  224. sehr einfach, die Dateien eigenen Vorstellungen anzupassen.
  225.  
  226.  
  227.  
  228. 5) Adresse des Autors
  229.  
  230. SciTech Software Development
  231. Haas Alexander
  232. Mitterndorf 150
  233. A-4801 Traunkirchen
  234. AUSTRIA
  235. e-mail: scitech@ping.at
  236. WWW: http://members.ping.at/scitech
  237.  
  238.  
  239.